<!DOCTYPE html>
<html lang="en">
<head>
	<meta charset="UTF-8">
	<meta http-equiv="X-UA-Compatible" content="IE=edge">
    <meta name="viewport" content="width=device-width, initial-scale=1">
	<title>Nodes reload secure settings API | ElasticSearch 7.7 权威指南中文版</title>
	<meta name="keywords" content="ElasticSearch 权威指南中文版, elasticsearch 7, es7, 实时数据分析，实时数据检索" />
    <meta name="description" content="ElasticSearch 权威指南中文版, elasticsearch 7, es7, 实时数据分析，实时数据检索" />
    <!-- Give IE8 a fighting chance -->
    <!--[if lt IE 9]>
    <script src="https://oss.maxcdn.com/html5shiv/3.7.2/html5shiv.min.js"></script>
    <script src="https://oss.maxcdn.com/respond/1.4.2/respond.min.js"></script>
    <![endif]-->
	<link rel="stylesheet" type="text/css" href="../static/styles.css" />
	<script>
	var _link = 'cluster-nodes-reload-secure-settings.html';
    </script>
</head>
<body>
<div class="main-container">
    <section id="content">
        <div class="content-wrapper">
            <section id="guide" lang="zh_cn">
                <div class="container">
                    <div class="row">
                        <div class="col-xs-12 col-sm-8 col-md-8 guide-section">
                            <div style="color:gray; word-break: break-all; font-size:12px;">原英文版地址: <a href="https://www.elastic.co/guide/en/elasticsearch/reference/7.7/cluster-nodes-reload-secure-settings.html" rel="nofollow" target="_blank">https://www.elastic.co/guide/en/elasticsearch/reference/7.7/cluster-nodes-reload-secure-settings.html</a>, 原文档版权归 www.elastic.co 所有<br/>本地英文版地址: <a href="../en/cluster-nodes-reload-secure-settings.html" rel="nofollow" target="_blank">../en/cluster-nodes-reload-secure-settings.html</a></div>
                        <!-- start body -->
                  <div class="page_header">
<strong>重要</strong>: 此版本不会发布额外的bug修复或文档更新。最新信息请参考 <a href="https://www.elastic.co/guide/en/elasticsearch/reference/current/index.html" rel="nofollow">当前版本文档</a>。
</div>
<div id="content">
<div class="breadcrumbs">
<span class="breadcrumb-link"><a href="index.html">Elasticsearch Guide [7.7]</a></span>
»
<span class="breadcrumb-link"><a href="rest-apis.html">REST APIs</a></span>
»
<span class="breadcrumb-link"><a href="cluster.html">Cluster APIs</a></span>
»
<span class="breadcrumb-node">Nodes reload secure settings API</span>
</div>
<div class="navheader">
<span class="prev">
<a href="cluster-nodes-info.html">« Nodes info API</a>
</span>
<span class="next">
<a href="cluster-nodes-stats.html">Nodes stats API »</a>
</span>
</div>
<div class="section">
<div class="titlepage"><div><div>
<h2 class="title">
<a id="cluster-nodes-reload-secure-settings"></a>Nodes reload secure settings API<a class="edit_me edit_me_private" rel="nofollow" title="Editing on GitHub is available to Elastic" href="https://github.com/elastic/elasticsearch/edit/7.7/docs/reference/cluster/nodes-reload-secure-settings.asciidoc">edit</a>
</h2>
</div></div></div>

<p>Reloads the keystore on nodes in the cluster.</p>
<div class="section">
<div class="titlepage"><div><div>
<h3 class="title">
<a id="cluster-nodes-reload-secure-settings-api-request"></a>Request<a class="edit_me edit_me_private" rel="nofollow" title="Editing on GitHub is available to Elastic" href="https://github.com/elastic/elasticsearch/edit/7.7/docs/reference/cluster/nodes-reload-secure-settings.asciidoc">edit</a>
</h3>
</div></div></div>
<p><code class="literal">POST _nodes/reload_secure_settings</code><br>
<code class="literal">POST _nodes/&lt;node_id&gt;/reload_secure_settings</code></p>
</div>

<div class="section">
<div class="titlepage"><div><div>
<h3 class="title">
<a id="cluster-nodes-reload-secure-settings-api-desc"></a>Description<a class="edit_me edit_me_private" rel="nofollow" title="Editing on GitHub is available to Elastic" href="https://github.com/elastic/elasticsearch/edit/7.7/docs/reference/cluster/nodes-reload-secure-settings.asciidoc">edit</a>
</h3>
</div></div></div>
<p><a class="xref" href="secure-settings.html" title="Secure settings">Secure settings</a> are stored in an on-disk keystore. Certain
of these settings are <a class="xref" href="secure-settings.html#reloadable-secure-settings" title="Reloadable secure settings">reloadable</a>. That is, you
can change them on disk and reload them without restarting any nodes in the
cluster. When you have updated reloadable secure settings in your keystore, you
can use this API to reload those settings on each node.</p>
<p>When the Elasticsearch keystore is password protected and not simply obfuscated, you must
provide the password for the keystore when you reload the secure settings.
Reloading the settings for the whole cluster assumes that all nodes' keystores
are protected with the same password; this method is allowed only when
<a class="xref" href="configuring-tls.html#tls-transport" title="Encrypting communications between nodes in a cluster">inter-node communications are encrypted</a>. Alternatively, you can
reload the secure settings on each node by locally accessing the API and passing
the node-specific Elasticsearch keystore password.</p>
</div>

<div class="section">
<div class="titlepage"><div><div>
<h3 class="title">
<a id="cluster-nodes-reload-secure-settings-path-params"></a>Path parameters<a class="edit_me edit_me_private" rel="nofollow" title="Editing on GitHub is available to Elastic" href="https://github.com/elastic/elasticsearch/edit/7.7/docs/reference/cluster/nodes-reload-secure-settings.asciidoc">edit</a>
</h3>
</div></div></div>
<div class="variablelist">
<dl class="variablelist">
<dt>
<span class="term">
<code class="literal">&lt;node_id&gt;</code>
</span>
</dt>
<dd>
(Optional, string) The names of particular nodes in the cluster to target.
For example, <code class="literal">nodeId1,nodeId2</code>. For node selection options, see
<a class="xref" href="cluster.html#cluster-nodes" title="Node specification">Node specification</a>.
</dd>
</dl>
</div>
<div class="note admon">
<div class="icon"></div>
<div class="admon_content">
<p>Elasticsearch requires consistent secure settings across the cluster nodes, but
this consistency is not enforced. Hence, reloading specific nodes is not
standard. It is justifiable only when retrying failed reload operations.</p>
</div>
</div>
</div>

<div class="section">
<div class="titlepage"><div><div>
<h3 class="title">
<a id="cluster-nodes-reload-secure-settings-api-request-body"></a>Request body<a class="edit_me edit_me_private" rel="nofollow" title="Editing on GitHub is available to Elastic" href="https://github.com/elastic/elasticsearch/edit/7.7/docs/reference/cluster/nodes-reload-secure-settings.asciidoc">edit</a>
</h3>
</div></div></div>
<div class="variablelist">
<dl class="variablelist">
<dt>
<span class="term">
<code class="literal">secure_settings_password</code>
</span>
</dt>
<dd>
(Optional, string) The password for the Elasticsearch keystore.
</dd>
</dl>
</div>
</div>

<div class="section">
<div class="titlepage"><div><div>
<h3 class="title">
<a id="cluster-nodes-reload-secure-settings-api-example"></a>Examples<a class="edit_me edit_me_private" rel="nofollow" title="Editing on GitHub is available to Elastic" href="https://github.com/elastic/elasticsearch/edit/7.7/docs/reference/cluster/nodes-reload-secure-settings.asciidoc">edit</a>
</h3>
</div></div></div>
<p>The following examples assume a common password for the Elasticsearch keystore on every
node of the cluster:</p>
<div class="pre_wrapper lang-console">
<pre class="programlisting prettyprint lang-console">POST _nodes/reload_secure_settings
{
  "secure_settings_password":"s3cr3t"
}
POST _nodes/nodeId1,nodeId2/reload_secure_settings
{
  "secure_settings_password":"s3cr3t"
}</pre>
</div>
<div class="console_widget" data-snippet="snippets/1407.console"></div>
<p>The response contains the <code class="literal">nodes</code> object, which is a map, keyed by the
node id. Each value has the node <code class="literal">name</code> and an optional <code class="literal">reload_exception</code>
field. The <code class="literal">reload_exception</code> field is a serialization of the exception
that was thrown during the reload process, if any.</p>
<div class="pre_wrapper lang-console-result">
<pre class="programlisting prettyprint lang-console-result">{
  "_nodes": {
    "total": 1,
    "successful": 1,
    "failed": 0
  },
  "cluster_name": "my_cluster",
  "nodes": {
    "pQHNt5rXTTWNvUgOrdynKg": {
      "name": "node-0"
    }
  }
}</pre>
</div>
</div>

</div>
<div class="navfooter">
<span class="prev">
<a href="cluster-nodes-info.html">« Nodes info API</a>
</span>
<span class="next">
<a href="cluster-nodes-stats.html">Nodes stats API »</a>
</span>
</div>
</div>

                  <!-- end body -->
                        </div>
                        <div class="col-xs-12 col-sm-4 col-md-4" id="right_col">
                        
                        </div>
                    </div>
                </div>
            </section>
        </div>
    </section>
</div>
<script src="../static/cn.js"></script>
</body>
</html>